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Foreword 



rd , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3 GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS-family covering the 3^^ Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.121: Advanced Alarm Management (AAM) Integration Reference Point (IRP): Requirements. 

32.122: Advanced Alarm Management (AAM) Integration Reference Point (IRP): Information Service 

(IS). 

32.126: Advanced Alarm Management (AAM) Integration Reference Point (IRP): Solution Set (SS) 

definitions. 

The Itf-N interface is built up by a number of IRPs and a related Name Convention, which realise the functional 
capabilities over this interface. The basic structure of the IRPs is defined in 3GPP TS 32.150 [4]. 

A single network fault may generate a large number of alarms over space and time. In a large and complex network, 
simultaneous network faults may occur, causing the network operator to be flooded with high volume of alarms. The 
high volume of alarms, typically the one received by an IRPManager via the getAlarmList or alarm notifications of 
Alarm IRP specification, greatly inhibits the operator ability to quickly identify and locate the responsible network 
faults. Advanced Alarm Management IRP is intended to provide methods to improve this situation. 
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Scope 



The present specifies the Solution Set definitions for the IRP whose semantics are specified in the Advanced Alarm 
Management (AAM) IRP Information Service (3GPP TS 32.122 [6]). 

This Solution Set specification is related to TS 32.122 vlO.O.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

- References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

- For a specific reference, subsequent revisions do not apply. 

- For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[I] 3GPP TR 21.905: "Vocabulary for 3GPP Specifications". 

[2] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[3] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[4] 3GPP TS 32.150: "Telecommunication management; Integration Reference Point (IRP) Concept 

and definitions". 

[5] 3GPP TS 32.121: "Telecommunication management; Advanced Alarm Mangement (AAM) 

Integration Reference Point (IRP): Requirements". 

[6] 3GPP TS 32.122: "Telecommunication management; Advanced Alarm Management (AAM) 

Integrations Reference Point (IRP); Information Service (IS)". 

[7] W3C REC-xml-20001006: "Extensible Markup Language (XML) 1.0 (Second Edition)". 

[8] W3C REC-xmlschema-0-20010502: "XML Schema Part 0: Primer". 

[9] W3C REC-xmlschema-1-20010502: "XML Schema Part 1: Structures". 

[10] W3C REC-xmlschema-2-20010502: "XML Schema Part 2: Datatypes". 

[II] W3C REC-xml-names-199901 14: "Namespaces in XML". 

[ 1 2] W3C SOAP 1 . 1 specification ( http://www.w3.org/TR/2000/NQTE-SQAP-20000508/) 

[13] W3C XPath 1 .0 specification ( http://www.w3.org/TR/1999/REC-xpath-19991 1 16) 

[14] W3C WSDL 1 . 1 specification ( http://www.w3.org/TR/2001/NQTE-wsdl-20010315) 

[15] W3C SQAP 1.2 specification ( http://www.w3 .org/TR/soap 1 2-part 1/) 

[16] 3GPP TS 32.306: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Solution Set definitions". 

[17] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)' 

[18] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Qbjects". 
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Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TR 21.905 [1], 3GPP TS 32.101 [2], 
3GPP TS 32.102 [3], 3GPP TS 32.150 [4] apply. A term defined in the present document takes precedence over the 
definition of the same term, if any, in TR 21.905 [1]. 

Alike Alarm: Two alarms are considered alike, if the corresponding alarm notifications are issued by the same object 
instance with the same alarmType, same perceivedSe verity, same probableCause and same specificProblem (if present). 

Lower Edge of Time Window: The point in time which determines the begin of a time span. 

Upper Edge of Time Window: The point in time which determines the end of a time span 

XML file: file containing an XML document 

XML document: composed of the succession of an optional XML declaration followed by a root XML element 

NOTE: See [7] ; in the scope of the present document. 
XML declaration: it specifies the version of XML being used 

NOTE: See [7]. 

XML element: has a type, is identified by a name, may have a set of XML attribute specifications and is either 
composed of the succession of an XML start-tag followed by the XML content of the XML element followed by an 
XML end-tag, or composed simply of an XML empty-element tag; each XML element may contain other XML 
elements 

NOTE: See [7]. 

empty XML element: having an empty XML content; an empty XML element still possibly has a set of XML attribute 
specifications; an empty XML element is either composed of the succession of an XML start-tag directly followed by 
an XML end-tag, or composed simply of an XML empty-element tag 

NOTE: See [7]. 

XML content (of an XML element): empty if the XML element is simply composed of an XML empty-element tag; 
otherwise the part, possibly empty, of the XML element between its XML start-tag and its XML end-tag 

XML start-tag: the beginning of a non-empty XML element is marked by an XML start-tag containing the name and 
the set of XML attribute specifications of the XML element 

NOTE: See [7]. 

XML end- tag: the end of a non-empty XML element is marked by an XML end-tag containing the name of the XML 
element 

NOTE: See [7]. 

XML empty-element tag: composed simply of an empty-element tag containing the name and the set of XML attribute 
specifications of the XML element. 

NOTE: See [7]. 

XML attribute specification: has a name and a value 

NOTE: See [7]. 

DTD: defines structure and content constraints to be respected by an XML document to be valid with regard to this 
DTD 

NOTE: See [7]. 
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XML schema: more powerful than a DTD, an XML schema defines structure and content constraints to be respected 
by an XML document to conform with this XML schema; through the use of XML namespaces several XML schemas 
can be used together by a single XML document; an XML schema is itself also an XML document that shall conform 
with the XML schema for XML schemas 

NOTE: See [8], [9] and [10]. 

XML namespace: enables qualifying element and attribute names used in XML documents by associating them with 
namespaces identified by different XML schemas 

NOTE: See [1 1], in the scope of the present document. 

XML complex type: defined in an XML schema; cannot be directly used in an XML document; can be the concrete 
type or the derivation base type for an XML element type or for another XML complex type; ultimately defines 
constraints for an XML element on its XML attribute specifications and/or its XML content 

NOTE: See [8], [9] and [10]. 

XML element type: declared by an XML schema; can be directly used in an XML document; as the concrete type of 
an XML element, directly or indirectly defines constraints on its XML attribute specifications and/or its XML content; 
can also be the concrete type or the derivation base type for another XML element type 

NOTE: See [8], [9] and [10].. 

3.2 Abbreviations 

For the purposes of the present document, the abbreviations given in TR 21.905 [1], in 3GPP TS 32.101 [2], 

3 GPP TS 32.102 [3], 3 GPP TS 32.150 [4], and the following apply. An abbreviation defined in the present document 

takes precedence over the definition of the same abbreviation, if any, in TR 21.905 [1]. 

AAM Advanced Alarm Management 

AAMRule Advanced Alarm Management Rule 

CM Configuration Management 

EM Element Manager 

IOC Information Object Class 

IRP Integration Reference Point 

IS Information Service 

Itf-N Interface N 

MIB Management Information Base 

NE Network Element 

XML extensible Markup Language 



4 Solution Set definitions 

This specification defines the following 3 GPP Advance Alarm Management IRP Solution Set definitions: 

Annex A provides the CORE A Solution Set. 
Annex B provides the XML Definitions. 
Annex C provides the SOAP Solution Set. 
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Annex A (normative): 
CORBA Solution Set 



This annex contains the CORBA Solution Set for the IRP whose semantics is specified in AAM IRP: Information 
Service (3GPP TS 32.122 [6]). 



A.1 Architectural features 

The overall architectural feature of Advanced Alarm Management IRP is specified in 3GPP TS 32. 122 [6] 

A.1 .1 Syntax for Distinguished Names 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300[18] 

A. 1.2 Notifications 

Notifications are sent according to the Notification IRP: CORBA SS (see 3GPP TS 32.306 [16]). 
Currently there are no AAM IRP notifications defined in 3GPP TS 32.122 [6]. 



A.2 Mapping 

A.2.1 General mappings 

Not appHcable. 

A.2. 2 Operation and notification mapping 

The AAM IS (3GPP TS 32.122 [6]) defines semantics of operations visible across the Itf-N. 

Table A.2. 2-1 indicates mapping of these operations and notifications to their equivalents defined in this CORBA SS. 

Table A.2.2-1 : Mapping from IS Operation to SS equivalents 



(3GPPTS 32.122) 




Qualifier 


activateAAMRule 


activate aam rule 


M 


getAAM Rules 


get aam rules 


M 


deactivate AAM Rule 


deactivate aam rule 


M 
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A.2.3 Operation parameter mapping 



The AAM IS (3GPP TS 32.122 [6]) defines semantics of parameters carried in operations across the Itf-N. 

The following tables indicate the mapping of these parameters, as per operation, to their equivalents defined in this 

CORBA SS. 

Table A.2.3-1 : Mapping from IS activateaamrule parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


aam rule type 


AAMConstDefs::AAMRuleType 


M 


aam_rule_parameter_list 


AAMConstDefs:: 
AAMRuleParameterList 


M 


filter 


AdvancedAlarmManegementConstDefs::FilterType 


M 


status 


Exceptions: 

AAMConstDefs::ActivateAAMRule, 

AAMConstDefs::AAMRuleAlreadyActive, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported, 

GenericlRPManagementSystem::OperationNotSupported 


M 


aam rule identifier 


AAMConstDefs:: AAMRuleldentifier 


M 



Table A.2.3-2: Mapping from IS getadvancedalarmmanagementrules parameters tO SS 

equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


aam rule list 


AAMConstDefs::AAMRuleList 


M 


Status 


Exceptions: 

AAMConstDefs::GetAAMRules, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported, 

GenericlRPManagementSystem::OperationNotSupported 


M 



Table A.2.3-3: Mapping from IS deactivateaamrule parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


aam rule identifier 


AAMConstDefs::AAMRuleldentifier 


M 


Status 


Exceptions: 

AAMConstDefs::DeactivateAAMRule, 

AAMConstDefs::SpecifiedRuleNotExisting, 

GenericlRPManagementSystem::ParameterNotSupported, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported, 

GenericlRPManagementSystem::OperationNotSupported 


M 



A.2.4 Notification parameter mapping 

None. 
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A.3 Solution Set definitions 
A.3.1 IDL definition structure 

Clause A.3. 2 defines the constants and types used by the AAM IRP. 

Clause A. 3. 3 defines the operations which are performed by the AAM IRP agent. 
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A.3.2 IDL specification (file name "AAlVIConstDefs.idI") 

// File: AAMConstDefs. idl 
#ifndef _AAM_CONST_DEFS_IDL_ 
#define _AAM_CONST_DEFS_IDL_ 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: AAMConstDefs */ 
module AAMConstDefs 

{ 

/* definition of types used in several operations for Advanced Alarm Management */ 

enum AAMRuleType { 
THRESHOLD_RULE , 
TRANSIENT_RULE, 
TOGGLE_RULE , 
VENDOR_SPECIFIC_RULE 

}; 

enum Status {SUCCESS, FAILURE, AAM_RULE_ALREADY_ACTIVE }; 
typedef string AAMRuleldentif ier; 

/* types used in operation activateAAMRule and */ 
/* types used in operation getAAMRules */ 

typedef string FilterType; 

typedef string TimeSpan; 

typedef string AlarmOccurenceThreshold; 

typedef string SlidingTimeWindow; 

struct AAMRuleParameterListForTrans lent Rule 

{ 

TimeSpan time_span; 



struct AAMRuleParameterListForThresholdRule 

{ 

AlarmOccurenceThreshold alarm_occurence_threshold ; 
SI idingTimeWindow si iding_t ime_window ; 



struct AAMRuleParameterListForToggleRule 

{ 

AlarmOccurenceThreshold alarm_occurence_threshold ; 
SlidingTimeWindow sliding_time_window_toggling_started; 
SlidingTimeWindow sliding_time_window_toggling_settled; 

}; 

typedef string VendorSpecif icParameterldentif ier; 
typedef string VendorSpecif icParameterValue; 

struct VendorSpecif icParameter 

{ 

VendorSpecif icParameterldentif ier vendor_specif ic_parameter_identif ier; 
VendorSpecif icParameterValue vendor_specif ic_parameter_value; 

}; 

typedef sequence <VendorSpecif icParameter> AAMRuleParameterListForVendorSpecif icRule; 
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/* The AAMRuleParameterList may contain a list of */ 

/* AAMParameters with different content depending on the */ 
/* AAMRuleType. */ 

union AAMRuleParameterList switch (AAMRuleType) 

{ 

case THRESHOLD_RULE : AAMRuleParameterListForTransientRule 

aam_rule_parameter_list_for_transient_rule; 
case TRANSIENT_RULE: AAMRuleParameterListForThresholdRule 

aam_rule_parameter_list_for_threshold_rule; 
case TOGGLE_RULE: AAMRuleParameterListForToggleRule 

aam_rule_parameter_list_for_toggle_rule; 
case VENDOR_SPECIFIC_RULE : AAMRuleParameterListForVendorSpecif icRule 

aam_rule_parameter_list_for_vendor_specif icRule; 



struct AAMRule 

{ 

AAMRuleldentif ier aam_rule_identif ier; 
AAMRuleType aam_rule_type ; 

AAMRuleParameterList aam_rule_parameter_list ; 
FilterType filter; 



typedef sequence <AAMRule> AAMRuleList; 



/* types used in operation deactivateAAMRule only */ 
/* none */ 



#endif // AAM CONST DEFS IDL 
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A.3.3 IDL specification (file name "AAMSystem.idl") 

//File: AAMSystem.idl 
#ifndef _AAM_SYSTEM_IDL_ 
#define _AAM_SYSTEM_IDL_ 

#include <AAMConstDef s . idl> 

#include <GenericIRPManagementSystem. idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: AAMSystem */ 

module AdvancedAlarmManagementIRPOperation_l 
{ 

/* 

If the system fails to complete an operation, then it can provide a reason 
to qualify the exception. The semantics carried in this reason are outside 
the scope of the present document . 

exception ActivateAAMRule { string reason; } ; 
exception AAMRuleAlreadyActive { string reason; } ; 
exception GetAAMRules { string reason; } ; 
exception DeactivateAAMRule { string reason; } ; 
exception Specif iedRuleNotExisting { string reason; } ; 

interface AdvancedAlarmManagement 

{ 

AAMConstDef s : : Status activate_aam_rule 

/* for the purpose of this operation see 3GPP TS 32.322 */ 
( 
in AAMConstDefs: :AAMRuleType 

aam_rule_type , 
in AAMConstDefs: : AAMRuleParameterList 

aam_rule_parameter_list , 
in AAMConstDefs: :Fi It erType filter, 
out AAMConstDefs: :AAMRuleIdent if ier 

aam_rule_identif ier 

) 

raises 
( 

ActivateAAMRule, 
AAMRuleAlreadyActive, 

GenericIRPManagementSystem: : ParameterNotSupported, 
GenericIRPManagementSystem: : InvalidParameter, 
GenericIRPManagementSystem: : ValueNotSupported, 
GenericIRPManagementSystem : : OperationNotSupported 



AAMConstDefs: : Status get_aam_rules 

/* for the purpose of this operation see 3GPP TS 32.322 */ 

( 

out AAMConstDef s : :AAMRuleLi St 
aam_rule_list 

) 
raises 

( 

GetAAMRules, 



GenericIRPManagementSystem 
GenericIRPManagementSystem 
GenericIRPManagementSystem 
GenericIRPManagementSystem 
) ; 



ParameterNotSupported, 
InvalidParameter, 
ValueNotSupported, 
OperationNotSupported 



AAMConstDefs: : Status deactivate_aam_rule 

/* for the purpose of this operation see 3GPP TS 32.322 */ 

( 

in AAMConstDefs: :AAMRuleIdent if ier 
aam_rule_identif ier 

) 
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( 

DeactivateAAMRule, 
Specif iedRuleNot Existing, 
GenericIRPManagement System 
GenericIRPManagement System 
GenericIRPManagement System 
GenericIRPManagement System 
) ; 



ParameterNot Supported, 
InvalidParameter, 
ValueNot Supported, 
OperationNot Supported 



}; 

#endif // AAM SYSTEM IDL 
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Annex B (normative): 
XML definitions 



This annex contains the XML Definitions for the Advance Alarm Management Integration Reference Point (AAM IRP) 
as it applies to Itf-N, in accordance with AAM IRP IS definitions [6] 



B.1 Architectural Features 

The overall architectural feature of AAM IRP is specified in 3G TS 32.122 [6]. This clause specifies features that are 
specific to the XML definitions. 

B.1 .1 Syntax for Distinguished Names 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300[18]. 

B.1. 2 Notification Services 

Currently there are no AAM IRP notifications defined in 3GPP TS 32.122 [6]. 

B.1. 3 IOC definitions 

This annex defines the XML syntax for the IOC definitions of the AAM IRP IS [6], which are used by the XML 
definitions for the AAM IRP notifications and the AAM IRP IS operations. 



B.2 Mapping 

Not present in the current version of this specification. 

B.3 Solution Set definitions 
B.3.1 XIVIL definition structure 

Clause B.3. 2 provides a graphical representation of the XML elements. 
Clause B.3. 3 provides XML definitions of AAM IOC as defined in [6]. 
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B.3.2 Graphical Representation 



fA{lv<)iice{IAI»rniMnniigemeiiitRul... 



KaaiAAMRuleParanietel Li:&tFoi T. 



Kaa:AAMRiilePiiriini^tei ListFoi T.. 



I xoii: A AMRiilePiii anietei ListFoi Ti aiisieiitRule 
■ FH"( ■■■ JEl — ^~Kaa:TimeSpan 



I xaa:AAMRiileParameterLi?tFoi Tin e^lioldPiile 



Maa:AAMRiileParanieterListForT.. 




Kaa:AAMRiileParanietei Li^tFoi U—H— (-— —JEH Kaa:Veii(lorS|>ecificParanieter H 
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B.3.3 XML Schema 'aamlOCs.xsd' 

<?xml version="l . 0" encoding="UTF-8" ?> 
< ! -- 

3GPP TS 32.126 AAMIRP IOC XML Schema 
aamlRPIOCs.xsd 
- - > 

<schema xmlns :xaa="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 126#aamIRPIOCs" 
xmlns="http : //www. w3 . org/2 l/XMLSchema" 

targetNamespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 126#aamIRPIOCs" 
elementFormDefault=" qualified" attributeFormDef ault= "unqualified" > 
<simpleType name="AdvancedAlarmManagementRuleIdentif ier" > 
<restriction base="string" > 

<length value= ' 64 ' > 
< /restrict ion> 
</simpleType> 

<simpleType name="AdvancedAlarmManagementRuleType" > 
<restriction base="string" > 

<enumerat ion value= " THRESHOLD_RULE " / > 
<enumeration value="TRANSIENT_RULE"/> 
<enumerat ion value= " TOGGLE_RULE " / > 
<enumeration value="VENDOR_SPECIFIC_RULE"/> 
< /restrict ion> 
</simpleType> 
<simpleType name="TimeSpan" > 

<restriction base="string" > 

<length value= ' 3 ' > 
< /restrict ion> 
</simpleType> 

<complexType name="AAMRuleParameterListForTransientRule" > 
<sequence> 

<element name="TimeSpan" type="xaa :TimeSpan"/> 
</ sequence > 
</complexType> 

<simpleType name= "AlarmOccurenceThreshold" > 
<restriction base="string" > 

<length value= ' 3 ' > 
< /restrict ion> 
</simpleType> 

<simpleType name="SlidingTimeWindow" > 
<restriction base="string" > 

<length value= ' 3 ' > 
< /restrict ion> 
</simpleType> 

<complexType name="AAMRuleParameterListForThresholdRule" > 
<sequence> 

<element name= "AlarmOccurenceThreshold" type= "xaa : AlarmOccurenceThreshold" /> 
<element name="SlidingTimeWindow" type="xaa: SlidingTimeWindow"/> 
</ sequence > 
</complexType> 

<complexType name="AAMRuleParameterListForToggleRule" > 
<sequence> 

<element name= "AlarmOccurenceThreshold" type= "xaa : AlarmOccurenceThreshold" /> 
<element name="SlidingTimeWindowTogglingStarted" type="xaa : SlidingTimeWindow"/> 
<element name= " SlidingTimeWindowTogglingSettled" type= "xaa : SlidingTimeWindow" /> 
</ sequence > 
</complexType> 

<simpleType name="VendorSpecif icParameterldentif ier" > 
<restriction base="string" > 

<length value= ' 64 ' > 
< /restrict ion> 
<simpleType name="VendorSpecif icParameterValue" > 
<restriction base="string" > 

<length value= ' 64 ' > 
< /restrict ion> 
<complexType name="VendorSpecif icParameter" > 
<sequence> 

<element name= "VendorSpecif icParameterldentif ier " 
type="xaa: VendorSpec if icParameterldentif ier" /> 

<element name=" VendorSpecif icParameterValue" type="xaa : VendorSpecif icParameterValue"/> 
</ sequence > 
</complexType> 

<complexType name="AAMRuleParameterListForVendorSpecif icRule" > 
<sequence> 

<element name=" VendorSpecif icParameter" type="xaa : VendorSpecif icParameter" 
maxOccurs= " unbounded " / > 
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</ sequence > 
</complexType> 

<complexType name= " AdvancedAlarmManagementRuleParameterList " > 
<choice> 

<element name="AAMRuleParameterListForTransientRule" 
type="xaa:AAMRuleParameterListForTransientRule"/> 

<element name="AAMRuleParameterListForThresholdRule" 
type="xaa : AAMRuleParameterListForThresholdRule"/> 

<element name="AAMRuleParameterListForToggleRule" 
type="xaa:AAMRuleParameterListForToggleRule"/> 

<element name="AAMRuleParameterListForVendorSpecif icRule" 
type= "xaa : AAMRuleParameterListForVendorSpecif icRule" /> 
</choice> 
</complexType> 
<simpleType name= " Filter" > 

<restriction base="string" > 

<length value='256'> 
< /restrict ion> 
</simpleType> 

<!-- Attributes of the advancedAlarmManagementRule IOC --> 
<element name="advancedAlarmManagementRuleIdentif ier" 
type="xaa:AdvancedAlarmManagementRuleIdentif ier"/> 

<element name= " advancedAlarmManagementRuleType " type= "xaa : AdvancedAlarmManagementRuleType " / > 
<element name="advancedAlarmManagementRuleParameterList" 
type= "xaa : AdvancedAlarmManagementRuleParameterList " /> 

<element name=" filter" type="xaa : Filter"/> 
</schema> 
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Annex C (normative): 
SOAP Solution Set 



This annex specifies the SOAP Solution Set for the IRP whose semantics are specified in AAM IRP: Information 
Service (3GPP TS 32.122 [6]). 



C.1 Architectural features 

The overall architectural feature of the AAM IRP is specified in 3GPP TS 32.122 [6]. This clause specifies features 
that are specific to the SOAP Solution Set. 

C.1 .1 Syntax for Distinguished Names 

The syntax of a Distinguished Name is defined in 3GPP TS 32.300[18]. 

C.1 .2 Notification Services 

Currently there are no AAM IRP notifications defined in 3GPP TS 32.122 [6]. 



C.1 .3 Supported W3C specifications 



The overall architectural feature of the Advanced Alarm Management IRP is specified in 3GPP TS 32.122 [6]. This 
clause specifies features that are specific to the SOAP solution set. 

The SOAP 1.1 specification [12] and WSDL 1.1 specification [14] are supported. 

The SOAP 1.2 specification [15] is supported optionally. 

This specification uses "document" style in WSDL file. 

This specification uses "literal" encoding style in WSDL file. 

The filter language used in the SS is the XPath Language (see W3C XPath 1.0 specification [13]). IRP Agents may 
throw a FilterComplexityLimit fault when a given filter is too complex. 

C.1 .4 Prefixes and namespaces 

This specification uses a number of namespace prefixes throughout that are listed in Table C.1.4. 
Table C.1.4: Prefixes and Namespaces used in this specification 



PREFIX 


NAMESPACE 


(no prefix) 


http://schemas.xmlsoap.org/wsdl/ 


soap 


http://schemas.xmlsoap.org/wsdl/soap/ 


aamlRPSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/32.1 26#AAI\/IRPSystem 


aamlRPData 


httD://www.3aDD.ora/ftD/sDecs/archive/32 series/32.1 26#AAI\/IIRP Data 


aam 


httD://www.3aDD.ora/ftD/sDecs/archive/32 series/32.1 26#aamlRP 


xn 


httD://www.3aDD.ora/ftD/sDecs/archive/32 series/32. 626#aenericNrm 


genericlRPSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/32.31 6#GenericlRPSystem 


ntflRPNtfSystem 


http://www.3gpp.org/ftp/specs/archive/32 series/32. 306#NotificationlRPNtfSystem 
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C.2 Mapping 

C.2.1 Operation and notification mapping 

The Advanced Alarm Management IRP IS (3GPP TS 32.122 [6]) defines semantics of operation and notification visible 
across the Itf-N. Table C.2.1 indicates mapping of these operations and notifications to their equivalents defined in this 
SS. 

Table C.2.1 : Mapping from IS Operation to SS Equivalents 



IS Operations in 3GPP TS 32.122 [6] 


SS Operations 


Qualifier 


activateAAMRule 


activateAAIVIRule 


M 


getAAMRules 


get AAIVI Rules 


M 


deactivateAAMRule 


deactivateAAIVIRule 


M 


getlRPVersion (note 1) 


getlRPVersion 


M 


getOperationProfile (note 1) 


getOperationProfile 





getNotificationProfile (note 1) 


getNotificationProfile 





NOTE 1 : These 3 operations are operations of IVIanagedGenericIRP IOC specified in 3GPP TS 32.312 [17]. 
The AdvancedAlarmlVlanagementIRP IOC of 3GPP TS 32.122 [6] inherits from it. 



C.2. 2 Operation parameter mapping 



The Advanced Alarm Management IRP IS (3GPP TS 32.122 [6]) defines semantics of parameters carried in the 
operations. The tables below show the mapping of these parameters, as per operation, to their equivalents defined in this 
SS. 

Table 0.2.2.1 : Mapping from IS activateAAMRule parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


aAMRuleType 


aAMRuleType 


M 


aAMRuleParameterList 


aAMRuleParameterList 


M 


filter 


filter 


M 


aAMRuleldentifier 


aAMRuleldentifier 


M 


status 


status 


M 



Table C.2.2.2: Mapping from IS getAAMRules parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


aAMRuleList 


aAMRuleList 


M 


status 


status 


M 



Table C.2.2.3: Mapping from IS deactivateAAMRule parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


advancedAlarmManagementRuleldentifier 


advancedAlarmManagementRuleldentifier 


M 


status 


status 


M 



C.2.3 Notification parameter mapping 

The Advance Alarm Management IRP IS (3GPP TS 32.122 [6]) does not currently define any notifications. 
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C.3 Solution Set definitions 
C.3.1 WSDL definition structure 

Clause C.3. 2 provides a graphical representation of the AAM IRP service. 
Clause C.3. 3 defines the services which are supported the AAM IRP agent. 

C.3. 2 Graphical Representation 

The WSDL structure is depicted in Figure C.3. 2 below, depicting port type, binding and service. The port type contains 
port type operations, which again contains input, output and fault messages. The binding contains binding operations, 
which have the same name as the port type operations. The binding connects to a port inside the service. 



^ AAMIRPPortType 




^@ AAMIRPBinding soap' doc' 

transport ; http ; //schemas . xmlsoap . org/soap/http 




^ AAMIRPSeruice 


^ ^ activateAAMRule 


^ AAMIRPPort 

Location ; http ; //www . 3gpp . org/Ftp/specs/archive/32_series/32 . 1 26#A AMIRP 


^ ^ getAAMRules 




> ^ activateAAMRule doc' 




K ^ deactivateAAMRule 


> ;± getAAMRules doc' 


^ GenericIRPPort 

Binding; genericIRPSystemiGenericIRPBinding JzJ 
Location ; http ; //www . 3gpp . org/Ftp/specs/archive/32 series/32 . 3 1 6#GenericIRP 




> ?i deactivateAAMRule doc' 









Figure C.3.2: Advance Alarm IRP SOAP Solution Set WSDL structure 
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C.3.3 WSDL specification 'AAMIRPSystem.wsdl' 

<?xml version="l . 0" encoding="UTF-8" ?> 

3GPP TS 32.126 Advanced Alarm Management (AAM) IRP SOAP Solution Set 
- - > 

<def initions xmlns="http: //schemas .xmlsoap.org/wsdl/" 
xmlns : soap="http: //schemas .xmlsoap.org/wsdl/soap/" 

xmlns :aamIRPSystem="http: //www. 3gpp.org/ftp/specs/archive/32_series/32 . 126#AAMIRPSystem" 
xmlns : aamIRPData= "http : //www . 3gpp . org/f tp/specs/archive/32_series/32 . 12 6#AAMIRPData" 
xmlns :xaa="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 126#aamIRPIOCs" 

xmlns :genericIRPSystem="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 316#GenericIRPSystem" 
targetNamespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 126#AAMIRPSystem" > 
<import namespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 316#GenericIRPSystem"/> 
<types> 

<schema targetNamespace="http : //www. 3gpp.org/ftp/specs/archive/32_series/32 . 12 6#AAMIRPData" 
xmlns="http : //www. w3 . org/2 OOl/XMLSchema" > 

<import namespace="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 126#aamIRPIOCs"/> 
<!-- The following types are defined for the AAM IRP operations --> 
<complexType name="AdvancedAlarmRule" > 
<sequence> 

<element name="AdvancedAlarmRuleIdentif ier" type="xaa : AdvancedAlarmRuleldentif ier"/> 
<element name= " AdvancedAlarmRuleType " type= "xaa : AdvancedAlarmRuleType " / > 
<element name= " AdvancedAlarmRuleParameterList " 
type="xaa : AdvancedAlarmRuleParameterList "/> 

<element name="Filter" type="xaa : Filter"/> 
</sequence > 
</complexType> 

<complexType name= " AdvancedAlarmRuleList " > 
<sequence> 

<element name= " AdvancedAlarmRule " type= " aamlRPData : AdvancedAlarmRule " 
maxOccurs= "unbounded" /> 
</sequence > 
</complexType> 
<simpleType name= " Status " > 

<restriction base="string" > 

<enumeration value=" Success "/> 
< enumeration value="AAMRuleAlreadyActive"/> 
<enumeration value= " Specif iedRuleNotExisting"/> 
<enumeration value="Failure"/> 
< /restrict ion> 
</simpleType> 

<!-- activateAAMRule Request- -> 
<element name="activateAAMRule" > 
<complexType> 
<sequence> 

<element name= " advancedAlarmManagementRuleType " 
type= "xaa : AdvancedAlarmManagementRuleType " / > 

<element name="advancedAlarmManagementRuleParameterList " 
type= "xaa : AdvancedAlarmManagementParameterList " /> 

<element name="f ilter" type="xaa : Filter"/> 
</sequence> 
</complexType> 
</element> 

<!-- activateAAMRule Response --> 
<element name="activateAAMRuleResponse" > 
<complexType> 
<sequence> 

<element name="advancedAlarmManagementRuleIdentif ier" 
type="xaa:AdvancedAlarmManagementRuleIdentif ier"/> 

<element name="status" type="aamIRPData : Status"/> 
</sequence> 
</complexType> 
</element> 

<!-- activateAAMRule Fault --> 
<element name="activateAAMRuleFault " > 
<simpleType> 

<restriction base="string" > 

<enumerat ion value= " OPERATION_FAILED " / > 
</restriction> 
</simpleType> 
</element> 

<!-- getAAMRules Request- -> 
<element name= " getAAMRules " > 
<!-- no input parameter --> 
<complexType> 
<sequence> 

<element name= "dummy" type=" string" minOccurs="0"/> 
</sequence> 
</complexType> 
</element> 
<!-- getAAMRules Response --> 
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<element name="getAAMRulesResponse" > 
< c omp 1 exTyp e > 
<sequence> 

<element name= " advancedAlarmRuleList " type= " aamlRPData : AdvancedAlarmRuleList " / > 
<element name=" status" type= "aamlRPData : Status "/> 
</sequence> 
</complexType> 
</element> 

<!-- getAAMRules Fault --> 
<element name= "getAAMRulesFault " > 
<simpleType> 

<restriction base="string" > 

<enumerat ion value= " OPERATION_FAILED " / > 
< /restrict ion> 
</simpleType> 
</element> 

<!-- deactivateAAMRule Request- -> 
<element name= "deactivateAAMRule" > 
<complexType> 
<sequence> 

<element name="advancedAlarmManagementRuleIdentif ier" 
type="xaa:AdvancedAlarmManagementRuleIdentif ier"/> 
</sequence> 
</complexType> 
</element> 

<!-- deactivateAAMRule Response --> 
<element name= "deactivateAAMRuleResponse" > 
< c omp 1 exTyp e > 
<sequence> 

<element name="status" type="aamIRPData : Status"/> 
</sequence> 
</complexType> 
</element> 

<!-- deactivateAAMRule Fault --> 
<element name="deactivateAAMRuleFault " > 
<simpleType> 

<restriction base="string" > 

<enumerat ion value= " OPERATION_FAILED " / > 
< /restrict ion> 
</simpleType> 
</element> 
</schema> 
</types> 
<message name="activateAAMRule" > 

<part name= "parameter" element= "aamlRPData : activateAAMRule"/> 
</message> 
<message name= 
<part name= 
</message> 
<message name=" 

<part name= 
</message> 
<message name= 

<part name=" 
</message> 
<message name= 
<part name= 
</message> 
<message name=" 
<part name=" 
</message> 
<message name= 
<part name= 
</message> 
<message name=" 
<part name=" 
</message> 
<message name= 

<part name=" 
</message> 
<portType name= " AAMIRPPortType " > 

<operation name="activateAAMRule" > 

<input message="aamIRPSystem: activateAAMRule"/> 
<output message= " aamlRPSystem : act ivateAAMRuleResponse " / > 

<f ault name= " act ivateAAMRuleFault " message= " aamlRPSystem : act ivateAAMRuleFault " /> 
</operation> 
<operation name= " getAAMRules " > 

< input message=" aamlRPSystem: getAAMRules "/> 
<output message= " aamlRPSystem : getAAMRulesResponse " / > 

< fault name= "getAAMRulesFault " message= " aamlRPSystem : getAAMRulesFault " /> 
</operation> 
<operation name="deactivateAAMRule" > 

< input message=" aamlRPSystem: deactivateAAMRule "/> 
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activateAAMRuleResponse"> 

parameter" element=" aamlRPData : activateAAMRuleResponse"/> 

activateAAMRuleFault " > 

parameter" element = "aamlRPData : activateAAMRuleFault " /> 

getAAMRules "> 

parameter" element=" aamlRPData : getAAMRules "/> 

getAAMRulesResponse " > 

parameter " element = " aamlRPData : getAAMRulesResponse " / > 

getAAMRulesFault " > 

parameter" element = " aamlRPData : getAAMRulesFault " / > 

deactivateAAMRuleRules" > 

parameter" element= "aamlRPData : deactivateAAMRule "/> 

deactivateAAMRuleResponse" > 

parameter" element ="aamIRPDat a : deactivateAAMRuleResponse"/:; 

deactivateAAMRuleFault " > 

parameter" element= "aamlRPData : deactivateAAMRule" /> 
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<output message= " aamlRPSystem : deact ivateAAMRuleResponse " / > 

< fault name="deactivateAAMRuleFault" message="aamIRPSystem:deactivateAAMRuleFault"/> 
</operation> 
< /port Type > 
<binding name= " AAMIRPBinding " type= " aamlRPSystem : AAMIRPPortType " > 

<soap : binding style= "document " transport= "http : //schemas . xmlsoap . org/soap/http" /> 
<operation name="activateAAMRule" > 
<soap : operation 
soapAction= "http : //www . 3gpp . org/f tp/specs/archive/32_series/32 . 126#activateAAMRule" 
style= " document " / > 
< input > 

<soap:body use=" literal "/> 
</ input > 
<output> 

<soap:body use=" literal "/> 
</output> 
<f ault name= "activateAAMRuleFault " > 

<soap: fault name=" activateAAMRuleFault" use=" literal "/> 
</fault> 
</operation> 

<operation name="getAAMRules" > 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 12 6#getAAMRules" style= "document "/> 
< input > 

<soap:body use=" literal "/> 
</ input > 
<output> 

<soap:body use=" literal "/> 
< /output > 
<fault name="getAAMRulesFault " > 

<soap: fault name="getAAMRulesFault" use=" literal "/> 
</fault> 
</operation> 

<operation name= " deact ivateAAMRule" > 
<soap : operation 
soapAction="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 12 6#deact ivateAAMRule" 
style= " document " / > 
< input > 

<soap:body use=" literal "/> 
</ input > 
<output> 

<soap:body use=" literal "/> 
</output> 
<f ault name= " deact ivateAAMRuleFault" > 

<soap: fault name=" deact ivateAAMRuleFault" use=" literal "/> 
</fault> 
</operation> 
</binding> 
<service name="AAMIRPService" > 

<port name="AAMIRPPort" binding= "aamlRPSystem: AAMIRPBinding" > 

<soap: address location="http : //www. 3gpp.org/ftp/specs/archive/32_series/32 . 126#AAMIRP"/> 
</port> 

<port name= "GenericIRPPort " binding= "genericIRPSystem : GenericIRPBinding" > 
<soap: address 
location="http : //www. 3gpp . org/f tp/specs/archive/32_series/32 . 316#GenericIRP"/> 
</port> 
</service> 
</def initions> 



ETSI 



3GPP TS 32.126 version 10.0.0 Release 10 



26 



ETSI TS 132 126 VI 0.0.0 (2011-05) 



Annex D (informative): 
Change history 



Change history 


Date 


TSG# 


TSG Doc. 


CR 


Rev 


Subject/Comment 


Old 


New 


2010-09 


SA#49 


SP-1 00505 


-- 


-- 


Presentation to SA for Information and Approval 


___ 


1.0.0 


2010-10 


- 


- 


- 


- 


Publication 


1.0.0 


10.0.0 



ETSI 



3GPP TS 32.126 version 10.0.0 Release 10 



27 



ETSI TS 132 126 VI 0.0.0 (2011-05) 



History 



Document history 


VIO.0.0 


May 2011 


Publication 



























ETSI 



